Google Drive Event Channel
Google Drive Event ChannelThe menu is a screen for installing and managing change notification (webhook) channels on a per-drive basis to apply the SHIELD DRM service to Google Drive.
Microsoft 365's이벤트 리시버This is the Google Workspace-specific integration management menu corresponding to __PH_0__, and it is only displayed to customers using Google Workspace.
Google Drive is a change notification (webhook) method for installing channels on a drive basis. Channels have an expiration time and are automatically re-registered periodically. Document events from drives where channels are not installed are not received, and conditional policies are not applied.
Prerequisites
To use the Google Drive event channel, the following conditions are required:in orderMust be prepared. If the previous step is not prepared, the state will not change even if the next step is executed.
| # | condition | Subject to be equipped |
|---|---|---|
| 1 | The customer company uses Google Workspace, and the tenant must be integrated with SHIELD DRM. | Client Administrator · Implementation Manager |
| 2 | Google Drive 이벤트 채널You must have role permissions. | SHIELD DRM Manager |
| 3 | Each user's SHIELD ID account must be linked to a Google Workspace account. | SHIELD ID Manager(Personnel Linkage) |
| 4 | Target users · The drive must be reflected in the list. | SHIELD DRM Manager (동기화) |
The order after conditions 1 and 2 are met is as follows.Account linking (Step 1) is done through SHIELD ID, not SHIELD DRM.
User Account Linking (Condition 3)
My Drive Channel isInstallation by userTherefore, you must know the Google Workspace account of the target user in order to install it. This connection is**SHIELD ID's Personnel Integration (Directory Synchronization)**is created.
| The path where the connection is created | Execution Subject |
|---|---|
| SHIELD ID Personnel Integration — Automatic Synchronization | Automatically reflect periodically if set |
| SHIELD ID Personnel Integration — Manual Synchronization | Direct execution by SHIELD ID administrator |
| User logs in to SHIELD ID with Google account | User himself (Automatically connected upon login) |
⚠️ If automatic synchronization is not set, the account will not connect even if it exists in both SHIELD ID and Google Workspace.In this case, the SHIELD ID administratorRun manual synchronizationmust be connected. A new member has joined or the list of
사용자 IDIf it is empty, please check this item first.
- Connection status is
내 드라이브tab's사용자 IDCheck by heat. Google Workspace email addresses are displayed only to connected users. - Unconnected usersNot a channel installation target.
채널 설치I전체 설치Executing it will not change the status of the user. - There is no separate notification screen indicating that the connection has been completed. Above
사용자 IDCheck with heat.
Screen Configuration
SHIELD DRM Admin Page연동 관리 > Google Drive 이벤트 채널Click on the menu to access.
It is provided in two tabs according to the difference in event recipients.
- **My Drive Tab:**Manage the installation status of channels for personal drives (My Drive) on a user basis.
- **Shared Drive Tab:**Manage the channel installation status by the organization's shared drive unit.
The two tabs are independently queried, installed, and synchronized. When switching tabs, the search term, filter, and page position are reset.
My Drive
List Information
| item | Explanation |
|---|---|
| User | The display name of the SHIELD ID user. |
| User ID | This is the Google Workspace email address linked to your SHIELD ID user account.**Information will be displayed only if a connected account exists.**If empty, it is not a target for channel installation (Prerequisite 3). |
| Channel Installation Status | Indicates whether a change notification channel is installed on the user's My Drive. |
| Last verification date | This is the time when the channel status was last checked. It is displayed based on the time zone of the connection environment. |
Channel Installation Status
설치: The notification channel has been successfully installed.미설치: The channel is not installed. Document events for the specified drive will not be received.지원하지 않음: This is the case when the account cannot use Google Drive, etc., and is not a target for channel installation.
채널 설치 상태Clicking the filter icon of the column allows you to filter the list by status. Only one status can be selected at a time, and초기화Release with the button.
status설치Order of verification when it is not
사용자 ID **Please check the column first.**Even users from the same organization may have their statuses displayed differently depending on whether the HR integration is reflected.
| status | First, check it. | Action |
|---|---|---|
미설치 | 사용자 IDWhether the email is displayed in the column | If empty → Reflect SHIELD ID integration (Prerequisite 3) If displayed →채널 설치or전체 설치Execution |
지원하지 않음 | 사용자 IDWhether the email is displayed in the column | If empty → Reflect SHIELD ID integration (Prerequisite 3) If displayed → Check the availability of Google Drive for the corresponding account |
| I ran the installation, but it remains the same. | how long has it been since it was executed | Since it is a request reception method, please wait a moment.새로 고침re-confirm |
Search
in the search box at the top rightUsername or EmailIf you enter and press the Enter key or click the search icon, only that user will be displayed.
Shared Drive
List Information
| item | Explanation |
|---|---|
| Drive Name | This is the name of the shared drive. |
| Drive ID | The unique identifier of the shared drive. |
| Channel Installation Status | Indicates whether a change notification channel is installed on the shared drive. |
| Last verification date | This is the last time the channel status was checked. |
Shared drives are all subject to channel installation, so unlike My Drive,지원하지 않음The status is not displayed. It is also unrelated to user account connection (precondition 3).
In the search box,Drive NameEnter.
Channel Installation and Uninstallation
Installation and Uninstallation of Selected Target
- Select the checkbox for the target item in the list. Clicking the checkbox in the header will select all items displayed on the current page.
채널 설치or채널 해제Click the button. If no items are selected, both buttons are disabled.- When the request is received, a notification popup will be displayed and the list will be refreshed.
Channel installation and uninstallation isRequest Reception MethodIt operates as. Immediately after the request, the status may not be reflected in the list, and after a moment
새로 고침Please check again with the button.
Full Installation and Full Uninstallation
Used to process all items in the list at once.
전체 설치: Installs change notification channels for all targets in the current tab list.전체 삭제: Unsubscribes from the change notification channels for all targets in the current tab list.
- Select the tab to process (My Drive / Shared Drive).
전체 설치or전체 삭제Click the button.- After confirming the target range in the confirmation window, proceed.
Two buttons are**The entire list of currently selected tabs, regardless of row selection.**is targeted. To process only the selected items with checkboxes,
채널 설치·채널 해제Please use the button.
- The two tabs operate independently, so to handle both My Drive and Shared Drive, you need to switch tabs and run each one separately.
- It may take time depending on the number of targets. As with the selection execution, it is a request reception method, so shortly after
새로 고침Please check the results. - in my drive tab
전체 설치even if you runUsers without a connected account will not be installed.(Prerequisite 3).
Synchronization and Refresh
동기화: Import and reflect the latest user list or shared drive list from Google Workspace. It only operates on the currently selected tab, so you need to run it separately for My Drive and Shared Drives.새로 고침: Retrieves the saved list again. Google Workspace lookup is not performed.
This screen's
동기화isUpdating the list of SHIELD DRMis. Precondition 3'sWork different from SHIELD ID personnel linkageand this button does not create a user account link.
Constraints
This is an item that is not supported due to product structure or cannot be bypassed.
| item | content |
|---|---|
| User Account Linking | **It relies on SHIELD ID personnel integration.**If automatic synchronization is not set, the account will not be connected even if it exists on both sides, and manual synchronization must be performed. |
| Channel Not Installed Drive | Document events are not received, and conditional policies are not applied. |
| New User · Drive | Not detected in real time. 동기화must appear in the list when executed or periodic batch is running. |
| Automatic Installation | even after appearing in the list**The channel is not installed automatically.**It must be executed directly by the administrator. |
| Channel Expiration | The channel has an expiration time and is automatically re-registered periodically. |
| Processing Reflection Timing | Installation and UninstallationRequest Reception MethodThis may not be reflected immediately. |
| Shared Drive | Since all are installation targets,지원하지 않음There is no status. |
| Menu Display Conditions | **Displayed only to customers using Google Workspace.**In the Microsoft 365 environment,이벤트 리시버The menu serves the same purpose. |
| Permission | Use of the menuGoogle Drive 이벤트 채널You need role permissions. The install, uninstall, and sync buttons will be disabled for administrators without permissions. |
Caution
전체 설치**installs a channel on all targets in the current tab list.**If you run it from the My Drive tab, all users' My Drives in the list will be the target, so please check the target scope before execution.전체 삭제**Executing this will stop receiving document events from all drives in that tab.**Documents on drives without channels are not subject to conditional policies.- When expanding the scope of policy applicationPlease check the installation status of the channel for the target drive first.
- When a new member joins the organizationSHIELD ID Personnel Linkage Reflection Confirmation →
동기화→채널 설치It is recommended to check in the order of.